home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / t3script.arc / T3SCRIPT.DOC < prev    next >
Text File  |  1990-04-14  |  13KB  |  277 lines
  1.                                T3SCRIPT
  2.                                ~~~~~~~~
  3.                   A COLLECTION OF SCRIPTS FOR TELIX 3
  4.                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6. What are they?
  7. ~~~~~~~~~~~~~~
  8.  
  9.            The SALT script language provided with and for TELIX 3, the
  10.            shareware communications software for IBM compatible computers,
  11.            is very powerful and capable of producing excellent tools and
  12.            accessories for the TELIX program. Unfortunately, the examples
  13.            (other than the "Host Mode" script) provided by EXIS Inc. are
  14.            fairly simple log-on scripts clearly aimed at the on-line
  15.            services available in the USA. This means that a number of
  16.            bulletin board systems which are available in the UK are not
  17.            catered for. My intention with this collection was therefore
  18.            twofold: firstly, to supply a set of log-on scripts covering the
  19.            main systems used in the UK and, secondly, to give a flavour of
  20.            the power of the SALT language by writing a few useful
  21.            utilities. The scripts will work with TELIX releases 3.0 and
  22.            3.1.
  23.  
  24.            The scripts in this collection are listed below but I should
  25.            first explain why you appear to have two of everything! One of
  26.            the chief factors contributing to the "power" of SALT scripts is
  27.            the fact that they are compiled (using the supplied compiler
  28.            CS.EXE) before they are used by TELIX 3. This means that the
  29.            original scripts (the files with the .SLT extension) are written
  30.            using an editor or ASCII word processor and these are then
  31.            turned into "programs" by CS (the files with the .SLC
  32.            extension). Therefore, what you have is a set of files (.SLT)
  33.            containing the readable "source" material and a second set
  34.            (.SLC) containing the compiled versions of the .SLT files -
  35.            these only being readable by TELIX. Right - enough of the
  36.            technical stuff for the moment, these are the scripts and what
  37.            they do:
  38.  
  39.            FIDO             Log-on script for Fido systems
  40.            FOREM            Log-on script for FoReM systems
  41.            GT-POWER         Log-on script for GT-Power systems
  42.            LYNX             Log-on script for Lynx systems
  43.            MICHTRON         Log-on script for MichTron systems
  44.            OPUS             Log-on script for Opus systems
  45.            PCBOARD          Log-on script for PCBoard systems
  46.            QUICKBBS         Log-on script for QuickBBS systems
  47.            SCHLIGHT         Log-on script for Searchlight systems
  48.            TBBS             Log-on script for TBBS systems
  49.            TOWERNET         Log-on script for Tower-Net systems
  50.            WILDCAT!         Log-on script for Wildcat! systems
  51.  
  52.            CAPTURE          Automatically opens a distict capture file
  53.                             for each call
  54.            CONNECT          Provides information on the current host,
  55.                             usually automatically on connection
  56.            TIME             Give the current time in the status line
  57.            HELP             Calls up the "Help Screen"
  58.            FKEY             Enables you to attach 'macros' to the function 
  59.                             keys
  60.            NULL             Avoids TELIX 3's opening "advert"
  61.            ON               Switches on Zmodem's AUTODOWNLOAD feature
  62.            OFF              Switches AUTODOWNLOAD off
  63.            PASSWORD         Extracts the password for the current 
  64.                             connection so that it can be "attached" to a 
  65.                             "hot-key"
  66.  
  67.            BBNOTES          A "database" of information about the boards in
  68.                             the Dialling Directory (needs the Dialling
  69.                             Directory UKBBTEL3.FON to be really useful)
  70.  
  71.  
  72.  
  73. OK, so what do I do with them?
  74. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  75.  
  76.            I must assume throughout this document that you already have a
  77.            copy of TELIX 3 and that you have configured it to work on your
  78.            system.
  79.  
  80.  
  81.            LOG-ON SCRIPTS, CAPTURE, CONNECT, TIME, HELP, FKEY, ON, OFF 
  82.            and PASSWORD:
  83.  
  84.            Some of these scripts need to be 'personalised' for your own
  85.            use; but don't panic - I don't expect you to alter any of the
  86.            souce material or recompile the scripts as you have to with the
  87.            examples included with the Telix program. What you MUST do,
  88.            however, before attempting to use the scripts is to run the FKEY
  89.            script while within Telix (see below).
  90.  
  91.            BBNOTES:
  92.  
  93.            You will need to see what this script already provides before
  94.            making any changes to it. I would suggest that, in the first
  95.            instance, you use the .SLC file as it stands. If you find the
  96.            script useful and would like to modify it to encompass your own
  97.            data, you can do so by following the steps at the top of
  98.            BBNOTES.SLT itself. You will need to recompile this script if
  99.            you decide to change it. The script is intended to be used as a
  100.            "companion" to my Dialling Directory - UKBBTEL3.FON. If you want
  101.            to use it with your own (smaller) Directory you will have to
  102.            make SUBSTANTIAL changes to the content of the .SLT file.
  103.  
  104.  
  105.  
  106. Organisation of Telix and Script files ...
  107. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  108.  
  109.            I suggest that, if you haven't done so already, you create a
  110.            formal structure for your TELIX files; something along these
  111.            lines -
  112.  
  113.            C:\TELIX         -   Put all the main TELIX files here. You 
  114.                                 should find most, if not all, of the 
  115.                                 following:
  116.  
  117.                                 ANSI.KEY
  118.                                 AVATAR.KEY
  119.                                 TELIX.CNF
  120.                                 TELIX.DOC
  121.                                 TELIX.EXE
  122.                                 TELIX.FON
  123.                                 TELIX.KEY
  124.                                 TX.LD
  125.                                 VT102.KEY
  126.                                 VT102ALT.KEY
  127.                                 VT52.KEY
  128.  
  129.            C:\TELIX\SCRIPT  -   Use this directory for all the script files,
  130.                                 both .SLT and .SLC versions, together with 
  131.                                 the compiler CS.EXE and its manual SALT.DOC.
  132.  
  133.            C:\TELIX\LOG     -   Keep all of your "Capture" files in this 
  134.                                 directory and also TELIX's usage log - 
  135.                                 TELIX.USE - if you have enabled that 
  136.                                 feature.
  137.  
  138.            You should now load load TELIX and amend the FILENAMES AND PATHS
  139.            where TELIX expects to find certain information:
  140.  
  141.                  1.  Open the Configuration Menu by pressing "ALT-O"
  142.                  2.  Enter "F" for the Filenames and Paths option
  143.                  3.  Then change item "C" to read "C:\TELIX\SCRIPT\"
  144.                  4.  Change item "D" to read "C:\TELIX\LOG\TELIX.CAP"
  145.                  5.  Change ITEM "E" to read "C:\TELIX\LOG\TELIX.USE"
  146.                  6.  Ensure that you save the new settings with item
  147.                      "W" of the Configuration Menu.
  148.  
  149.  
  150.  
  151. The FKEY Script ...
  152. ~~~~~~~~~~~~~~~~~~~
  153.  
  154.            Several of the scripts are most useful when they are "attached"
  155.            to function keys so that they can be called up quickly when
  156.            required.
  157.  
  158.            First of all, you should run the FKEY script which will set up
  159.            the function keys for you with the minimum of effort. At the
  160.            same time it will provide details of YOUR NAME for future use by
  161.            the log-on scripts, thereby personalising the log-on scripts
  162.            for YOUR use.
  163.  
  164.            FKEY is called up from within TELIX by pressing "ALT-G" and
  165.            typing in the script name FKEY [Return]. Be careful though -
  166.            there are no safeguards to stop FKEY overwriting a previous
  167.            version of TELIX.KEY. If you have saved your own key assignments
  168.            in TELIX.KEY you will have to re-enter them after running FKEY.
  169.            The NAME information attached to F1, F2 and F4 is VITAL to the
  170.            operation of the log-on scripts and these key assignments should
  171.            not be changed. Simply follow FKEY's instructions and tell the
  172.            program to save your details when you are happy that you have
  173.            entered them correctly.
  174.  
  175.            That's it! Your function keys will now do the following jobs
  176.            while in TELIX:
  177.  
  178.                   F1  Sends your first name to the host
  179.                   F2  Sends your surname to the host
  180.                   F3  Sends your password to the host
  181.                   F4  Sends your full name to the host
  182.                   F5  Runs the CONNECT script and shows who you are 
  183.                       currently connected to, the baud rate, current time 
  184.                       and date.
  185.                   F6  Runs the BBNOTES script and give you various pieces 
  186.                       of information about a Dialling Directory entry. You
  187.                       choose which board you want details of by typing in 
  188.                       the Dialling Directory number of the board in 
  189.                       question followed by [Return].
  190.                   F7  Calls up the "Help Screen"
  191.                   F8  Gives the current time in the bottom left-hand corner
  192.                       of the terminal screen
  193.                   F9  Switches on Zmodem Autodownload
  194.                   F10 Switches off Zmodem Autodownload
  195.  
  196.  
  197.  
  198. OK, I've done that. What's next?
  199. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  200.  
  201.            Having done that you are almost there. If you are using
  202.            UKBBTEL3.FON as your Dialling Directory, the log-on script files
  203.            will run automatically upon connection with the host system. If
  204.            you are using the log-on scripts with your own Directory, you
  205.            must ensure that you complete the "Script" section of each entry
  206.            with the appropriate script name. CAPTURE and CONNECT are
  207.            "called" as subroutines by the log-on scripts and they too will
  208.            run automatically. Having tried the scripts as they stand, if
  209.            you do not like the automatic invocation of CAPTURE or CONNECT,
  210.            they can be disabled. Instructions are in the respective log-on
  211.            .SLT files. If you do 'switch off' these features by modifying
  212.            the .SLT files, you will have to recompile them using CS.EXE
  213.            before the changes will become effective.
  214.  
  215.  
  216.  
  217. The NULL Script ...
  218. ~~~~~~~~~~~~~~~~~~~
  219.  
  220.            You can get rid of the opening "advert" for TELIX 3 by hitting
  221.            [Return] twice in rapid succession after you've typed the
  222.            filename to load the program. However, there is a more elegant
  223.            (and perfectly legal) way of achieving the same result. All you
  224.            need to do is create a batch file called (let's say) TLX.BAT
  225.            containing just one line: TELIX /SNULL
  226.  
  227.            Having saved the batch file, if you now type TLX [Return] TELIX
  228.            will load without the ad!
  229.  
  230.  
  231.  
  232. Anything else I should know?
  233. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  234.  
  235.            Occasionally a log-on script will fail to work properly because
  236.            of line noise. Usually when you receive a prompt from the host
  237.            which is unrecognisable because of noise a carriage return will
  238.            cause the prompt to be sent again. If this time the prompt is
  239.            readable the script will continue as normal. The function key
  240.            commands above give you a backup to the log-on scripts where you
  241.            have not put a Script name against the entry in the Dialling
  242.            Directory or where the script loses its way because of chronic
  243.            line noise.
  244.  
  245.            These scripts work well with UKBBTEL3.FON the Dialling Directory
  246.            of over 300 UK bulletin boards which is also my handiwork.
  247.            UKBBTEL3.FON should be available (as UKBBTEL3.ARC) on the board
  248.            where you found the T3SCRIPT.ARC file. If not, you can certainly
  249.            get it from FRIX (see below).
  250.  
  251.  
  252. A request ...
  253. ~~~~~~~~~~~~~
  254.  
  255.            No, I don't want your money! The scripts in this collection are
  256.            really just examples of what can be done with SALT. I am not a
  257.            programmer and, if I can write scripts so can YOU. If you do
  258.            write anything useful I'd be grateful if you would upload a copy
  259.            to FRIX (see below). It may well be possible to make your script
  260.            more widely available to users of TELIX 3 as part of future
  261.            collections.
  262.  
  263.  
  264.  
  265. And finally ...?
  266. ~~~~~~~~~~~~~~~~
  267.  
  268.            Oh yes, any comments on T3SCRIPT should be addressed to me:
  269.  
  270.                       Terry Robertson
  271.  
  272.                  at   FRIX .. Reading
  273.                       0734-420229
  274.                       (Netmail 253/112)
  275.  
  276.            This excellent board is, of course, included in UKBBTEL3.FON.
  277.